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Identification 

Manuscrint typing and editing 
TYPSET, RUNOFF 
J. Saltzer, X6039 


Revised: 9/30/66 


Purpose 

The command TYPSET is used to create and edit 12-hit BCD 
line-marked files. This command permits editing and 
revising by context, rather than by line number. The 

command RUNOFF will print out (in a format subject to 
control words placed in the file via TYPSET) a 12-bit BCD 
line-marked file in manuscript format. RUNOFF contains 
several special control features which were not available 
with the DITTO command, including tvpe-j us t i f i ca t i on . 

References 


This work represents one more iteration in the arduous task 
of creating an "ultimate" editing scheme. As such, it is 
primarily a synthesis of techniques which have been proven 
valuable in several separate problem areas. It is felt that 
this particular synthesis brings to bear on the editing 
problem an easy to use package of techniaues, and might 
provide a model for an editor on a "next generation" 
time-sharing system. Here is a list of some of the sources 
of ideas for these commands: 


J. McCarthy 
S . P i n e r 
P. Samson 

Comp. Center staff 
M. L. Lowry 
M. P. Barnett 
V. H. Yngve 
R . S . Fabry 
A. L. Samuels 
F. J. Corbato” 


(Colossal typewriter) 
(Expensive Typewriter) 
(Justify) 

(Input, Edit, and File) 
(Memo, Modify, and Ditto) 
( Photon ) 

( Com i t , Ved i t ) 

(Madbupr) 

(Edits) 

( Rev ? se ) 
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An Edi t-hy-Context Program 


Program Name ; TYPSET 
Qpsnr i ot i on 

TYPSET is a command program used to type in and edit 
memorandum files of English text. TYPSET, along with the 
command RUNOFF, is a replacement for the (old system) 
commands MEMO, MODIFY, and DITTO. Editing is specified by 
context, rather than line number, and innut is accomplished 
n t high speed since the program does not respond between 
1 i nes . 

Usage 


TYPSET name 

"name" specifies the primary name of a file to he edited, or 
of a file to be created; it may be absent, in which case a 
file is to be created, and must be named later by the "FILE" 
request . 

When TYPSET is ready for typing to begin, the word "Input" 
or "Edit" is typed, and the user may begin. If he is 
creating a file, he begins in high-speed input mode; if he 
is editing a file, he begins in edit mode. 

H i gh - Sneed I npu t Mode 

In high speed input mode, the user may type. linns of up to 
360 characters in length (e.g., 120 underlined characters) 
separated by carriage returns. He does not wa i t . for 
response from the program or the supervisor between lines, 
but may type as rapidly as desired. The full character set 
of his keyboard may be used. 

The user leaves high-speed input modo and enters edit mode 
by typing an extra carriage return. When .switching modes, 
the program acknowledges the switch by typing the name of 
the new mode, "Input" or "Edit". 


Ed i t Mode 


In Edit mode, the program recognizes "requests" of the form 
given below. All requests take effect immediately on a copy 
of the file being edited. Except where a request is 
expected to cause a response, such as "PRINT," successive 
requests may be entered immediately on successive lines 
without waiting for a response from the program. Each 
separate request must begin on a separate line. Program 
responses are typed in red, if you use a two-color ribbon. 
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The standard 12-bit character set is available. (See 

Section AC. 2. 01.) The preset erase character is # and the 
preset kill character is 0 . The 1(150 characters lozenqe, 
cent siqn, pi us-over-mi pus, exclamation point, and percent 
should not he used in TYPSET memos. Anticipated future 
changes to the 1050 character set are not guaranteed to 
preserve the code values or existence of these characters. 

Requests 

Editing is done line by line. We may envision a pointer 
which at the beninnin.'T of editing is above the first line of 
the file. This pointer is moved down to different lines hv 
some requests, while other requests specify some action to 
be done to the line next to the pointer. All requests 
except FILE may he abbreviated by o-ivinr only the first 
letter. Illegal or misspelled requests will he commented 
upon and ignored. 

For purposes of description, the requests have hepn divided 
into two categories, those necessary for effective use of 
the command, and special-purpose requests which are not so 
generally useful. The first category includes eiqht 
requests : 

LOCATE character strinq 

This request moves the pointer down to the first line 
which contains the <ri ven character string. Only. enough 
of the line need be specified to identify it uniquely. 
Since the pointer only moves down through the file the 
second occurrence of a line containing a (riven 
character strinq may be located hy o-ivinq the L n 0ATF 
request twice. The line v-«h|rh has been found is 
printed in its entirety. 

It is not necessary to count blank characters exactlv. 
If one blank character appears at some point in the 
request strin ,T , anv number of blank characters or tabs 
at the corresponding point in the file wi 1 1 he deeded 
to satisfy the request. If 2 hlank characters anpear 
together in the request strin 0 :, there must he 3 1 least 
two blank characters or tabs at the cor respond i n "• point 
in the file, etc. 

If the LOCATE request fails to find a line containinr 
the qiven character strinq, a message is printed, and 
the pointer is set to point after the last line in the 
file. Any requests which were typed in between the 
LOOATF which failed and the messaqe from the nro^ram 
about the failure are ignored. Another LOCATE request 


CTSS PPOPRAM^FP ' c ninnp 


Serf inn A M . A . m 


9/fifi U 


'■/' ! 1 Toyc t h P 

hp.^in another 

p p I MT n 


Pointer Keck to ). nn 

sr_lr down t h r*o!iph t K P ff 


0 -F 

1 e . 


tho 


Hln 


to 


NFXT 


Starting t t^p noint-pr n t 

typewriter console. The nointer r^V pr,ntpr| or the 
line printed. If n is ahsen? i ? 1 * * the Inst 

the pointer is not moved |f'th P ^ ,S n rJn ted and 
1'ne (e..., above or '*• [ f f, ^ ' " tAr '* not at a 

^W,d, only a „rri^ rhfuV !' iy^^ * 


j ust 


"FI.FTF 


S r" C7 1 5 ^ "f” mp \/ c* c ♦- L, • 

u ah5 " nf ' id:o;:, d r t h"" n ”rn„! f 


"n" 


This rennest deletes "n" 

currently heinr pointed at. ^ th 


"n" 


lest deleted line If 

- th ; 

IMSPPT new line 


the line 

pointer is left at the 
LL ™ SPnt ;* the current 1 i n e 


new 


line hy 

request 
of the 
line. 


To 


The 1 | p P "new line" will • 

the pointer. Thp ^J"} 1 ^ ^te r the 

rV’ speed input mode. All i • 

"HP he f ne Aoln/e^"? 
to edit mode hv tv nine = n ♦. 

set to the lacr • nxtra return, the 

- in the last inserted line te <-k 
request e, V e r |s _, p |r , SFPT n * ,f 5 h o very first 

f !|»; the inserted H„., ar , n „ r °. d »J ‘j£ 


the 

f'Ve several iMgpp-p 
return to switch to 
typed are inserted 
/.hen the user returns 

Tlirn *- I • 

no i nter is 
ed i t 
a re 
i s 


OMAunr /string 1/strino- 


2/ 


n n 


"^tM'-'i^lSri! at/ thP str? ^ of 

'/strinr 2". I^^fn, ft ■ ^ .^rio* of 

inserted at the i P • • ^ ' S vo ' r| ' "string- 

not appearing wi th i n^! Jhe^ UPP - Anv 
!! p n d ! n Plqrp ° f the "slash" 
n ,s present, the change 
nes, ^ starting with the one 
I'nes in which a W as 


characters 
cha racters 
2" wi 1 1 he 

chnrar'w 't'"/ . chnct y 

eherecter If b ° 

„„ - -t . ir a number , 

ceques t Will affect "n" 

^.nc pointed at. All 

made are printed. The i as t 



9/fin 


c t s s p r o o p \ *: m ^ 


in I < 1 > r 


So*" ■*- 


ion AH. q. o; 


change was made 


nnT s J^ned is Printed whether a 

not. The pointer is loft ->*■ ..u , - - 

the letter "R" f s absent- at thp lq st line scanned. 

.7, nt/ 3,1 occurrences of "ctrin* m ... 

in f- - A NR F- replies t strinp-s 


FI LF 


counted exactly. 
F xarno 1 e : 

line: 

raques t : 
new line: 
rnques t : 
new line: 
rcques t : 
new line; 
reques t : 
new line; 
reqties t : 
request : 
reques t : 
new line; 

name 


or 
If 
of 

"ft" is 
a line 
has no 
must he 


™ in Roston - 

,n Ro,tnn 

wangf"-"!?? f y 

CHAN OP* 1 j^jAp.day. in.Roston. 

I ti s. a. nice. day. in.Roston 
CHANRF "tis"t is" ‘ * 

CHANRF » . » i -Q 
CHAMRF 'on 'on.' 

It is a nice day in Boston. 


TOP 


a™%o r Tu: ihe^ted •'"tin, process 

file ts filed as >W (MEMO, m P ^' Sk -„ T h “ -"ted 

the or lei no 1 none .in |,e need f j n;,n !; 15 absent. 

deleted. If no none „os orianallv ei ' ^ ? Mpr fil * 

is ignored and a comoent made I f A'nonii"' ■ th T request 
a file of that name „ ready exists " 13 *' v ?" and 

:5or -" 

vVul?r n,Snr ^' r typ?ne r ^^ 7 -l. 


Hnn -T?f,:? VP3 th " n°lnt^r hoc., to ,h„,e the first 

hot 7/!ir'p?ohoMy r n^r S he *Za’ n Z Purposes, 

previously described. s offnn the ones 

BOTTOM 


This request moves the pointer to th D -t 
and switches to input node? All l^eT n 7 0 f 
typed are piaced at the end oi jhi !n/ h ' Ch 


the 
a re 


f i le 
then 
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q/sfi s 


F^A c -F r 


The character * ! o " 

become s 

£ h p p p* n c n 

character. 

normally, the chare rto K 

is 

thp 

erase 

character. 

(The eras® character is used to 
tyned character or characters.) 

del e t e 

the 

previously 


K I LI. c 


The character "c" 

become s 

the 

kill 

character. 

Normal 1 v, the character 

"0" is 

the 

kill 

character • 


(The kill character is used to ^plete the entire line 
currently bein^ typed.) 

VERIFY n 

If the parameter, M p" is "OFF", the following program 
responses are nor automatically typed: 

"INPUT" or "EDIT" when the node is changed. 
Lines found by the F I MP or L n CAT^ requests. 
Lines chanced hy a CUANP^ request. 

If the parameter "p" is "on", the responses are 
restored. The command hoping jp "ON" mode. 

PETYPF new 1 i ne 

The line "new line" replaces the line beinc pointed at. 
The first blank following the request word is part of 
the request word and therefore is not part o f the new 

line. 

F I M n character strinc 

This request moves the pointer do»'n to the first line 
which starts w? th the sivpn character strine. 

SPLIT name 

All the lines above the pointer are split into a file 
called "name (MEMO)". Any old cony of "name (.MEMO)" is 
deleted. The remainder of the file may still be 
edited, and filed under another name. The SPLIT 
request may be used several times during a sinp-le edit, 
if desired. Unless at least one "T0 n " request h->s been 
civen, "name" must be different from the original name 
of the file beinft split. 

Racks nac ? nr 

The backspace key may be used to create o''erstuek or 
underlined characters. All overstruck characters are stored 



C T S ~ PROOR AMM PR *S ..fill | n F 


S PC r inn A M 


0 / S h 


ndenendont of the w^.4 P v wer® oy pe 
and F i N n - r pqupst srr; n~s are a i so 


: a standard format 

!-. CWAMOF- ' poATpl 

y u i* I r — rinn f* l rJ M - tphups ^ ^ r r ; ^ ■- c -« ^ a -si- 

rnmpmhpr d th° th i 5 s ; ,lndar ? forma t, so it is 'not' necessary ’ to 
tvnpd } th a ordpr . ln whIch an nverstrurk character was 
typed n order to identify it. For example, suppose the 

The N^Rf’AL M {*DF statement of MAD 


had been 
backspaces 
in NORMAL 


typed in by typing the letters NORMAL, five 
/ a slash, and four forward snares. The slashed (* 
can he chanced to a standard 0 bv tvpinc 


CHANOF ' {?! ' 0 1 


Restricted Names and Recovery Procedures 

Tvvo special names are used for ? ntermed ? e t e files bv TY pc FT 

( I MPIIT F| | f ) 

(INPT 1 FI L F ) 


o? 1 iS?i n 5f\!! ,,,T ^ du " ncp (or a CTS - S system breakdown! one 
both of these files may be found. (Whenever a nn|T 

sequence has been riven, a SAVF command should be issued to 
save e status. of all files.) Feoause the (Inpti fi l C 1 
contains a comnlete cony of the file since the 

last TOP command, it nay be renamed an d used as a source 

t e and may perm.t recovery of lost requests. The (Impuj 
, ; . con ^ a 1 ns only that part of the file above the nninfer 

^nd therefore contains °n; v , partial r^orTnf th» original 
P, /• Id Ofifnal fil. rs navar rtolatad until tha naw, 
edited file has been successfully written and closed 


The user's disk status and file di rectory are undated 
end of each nass through the f;i 0/ therehw nr 
additional insurance against accidental loss. 


a t the 
o v i d i n p 


The intermodiete files are normally written 
mode. If Che user's track nuoFe heromes ay> 
ed i tine, TYPFFT will switch to temporary node 
files. If it is per ess a r y to l<=>ave the p-J i 
temporary nn^, e will he m ado 


|n pn ps nopf 
n U S F n rl -.'h | 1 p 
? n t e rmp r| i r> t e 
F e rl file in 


If a new fil° n.->ne is to he 
! n termor! i r, w f ;i o s ) and thp user 
sane name | n his directory, he is 
to delete the 0 i^ file. 


created ( including ^^cse 
already has a file 0 f t ho 
first asked ?F hp wishes 
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Summary of TYpSFT requests. 

n h h r e v . renues t response 

Basic requests : 


L 

LOCATF strinpr 

1 i ne found * 



end-of-f i 1 e 

n 

OF I.FTF n 

end-of -f i 1 e 

N 

NFXT n 

end-of-f i 1 e 

1 

INSFPT 1 ine 

none 

P 

PR 1 NT n 

printed 1 ? nes , 



end-of-f i 1 e 

c 

OH A NOE 0 xxQyyO n 0 

changed 1 i nes 

T 

TOP 

none 


P 1 1. F name 

Ready message 

Spec ini -purpose 

requests : 


R 

BOTTOM 

" 1 nput" * 

V 

VF p 1 F Y ON (or 0 p F) 

none 

s 

SPL IT name 

no name p-iven 

n 

oftypf new lino 

none 

F 

p P AS p x 

none 

K 

KILL x 

none 

F 

F 1 NO str i nc 

line found * 



end-of-f? 1 e 


★ 


These responses will not occur if VERIFY node is off 


py^S ppQnpMrFP 1 S nu| p >" 


Portion A u . R 


O'! 


Cj / ^ f“i I 


a P . I r n t ■ 


1 r s 


•• i n? 


rr Tvnr. O, 


C - • 


Program Mane : RIIMDFF 
Program 0 esc r ? Dtion 

PHNOFF is a command used to typo nut memorandum fi1«s of 
Fn-lish text, in manuscript format. Control words scattered 
in the text may he used to provide detailed control over the 
format. Input files may be prepared by the context editor, 
TYPSF.T. 


1 1 s a - e 


RUNOFF NAM FI -PI- -P?- 


- Pn- 


NAMF 1 is the primary name a file "NAM PI (MFMrn 
to he typed out. 


PI, P2, etc., are 


a n v 


number 


ftp 


followin' 5, parameters, in any order: 


STOP 
NO vi A I T 

PAOF. n 
P.ALI. n 


Pause between pa-es. 

Suppress tf* e initial pause to load paper and 
the pause between pap-es. 

p.Ptrin printing with the patre numbered "n". 


Typewriter is ijs in- printing ball "n 


al 1 
"n" 


"n". If 

this parameter is omitted. Runoff assumes 
that the hall in use will properly print 
CTSS characters in the file. The number 
is engraved on top of the printing ball. 
CTSS characters not appearing op the ball 
bein.c used will be printed as Ma^ks, so that 
the'/ may be drawn in. 


Control Words 

Input generally consists of Fn-lish text, /RO or Jewer 
r l_, a rnc1;prs ^ line. Control words must he-in a n°w line, 
and ' the'/ “ be-in with a period so that they may be 
distinguished from other text. RUNOFF does not print the 
control words. 


.line 1 en-th n 


Set the line 1 en-th to "n". The line len-th is nreset 
to RO. 
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. i nd pnt n 

Set thp number of snares to bn inserter! at the 
bee i nn i nr each line to "n". Indent is oreset to 0. 

.undent n 

In an indented region, this control word causes a 
break, and the next line only will be indented n spaces 
fewer than usual. This control word is useful for 
typing indented numbered paragraphs. 

.paper length n 

This control word is used for running off a memorandum 
file on non-standard paper. The number "n" is a line 
count, figured at 6 lines per inch. If this control 
word is not given, "n" is assumed to be fifi, for 11-inch 
paper. 

.single space 

Copy is to be single spaced. This mode takes effect 
after the next line. (The normal mode is single 
space. ) 

.double space 

Copy is to be double spaced. This mode takes effect 
after the next line. 

.begin page 

Print out this page, start next line on a pew page, 
.adjust 

Right adjust lines to the right margin hv inserting 
blanks in the line. The next line is the first one 
affected. (This is the normal mode.) 

. noj us t 

Do not right-adjust lines. 


.fill 

Lengthen short lines by moving words from the following 
line; trim long lines by moving words to the following 
line. (This is the normal mode.) A line beginning 
with one or more blanks is taken to be a new paragraph, 
and is not run into the previous line. 
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,pnf I 1 1 

Print all linns exactly as they appear without ri°-ht 
adjustment or filling out. 

.page -n- 

Print pa p;e numbers. (The first page is not given a 
page number. It has instead a two-inch top margin. 
See also "Manuscript Conventions", below.) If "n" is 
present, insert a nage break and number the next page 
"n". Mote that RUNOFF does not print completely emoty 
pages . 

.space -n- 

Insert "n" vertical spaces (carriage returns) in the 
copy. If "n" carries spacing to the bottom of a page, 
spacing is stopped. If " n " is absent or 0, one space 
i s i nserted. 

.header xxxxxxxxxxxxxxxx 

All of the lire after the first blank is used as a 
header line, and anppars at the top of each page, along 
with the page numher, ?f specified. 


.break 


The lines before and after the ".break" control word 
will not be run together by the "fill" node 0 f 
onerat i on. 

. center 

The following line is to be centered between the left 
and right margins. 

. 1 i tera 1 

The following line is not a control word, despite the 
fact that it begins wit h a period. 

.heading mode P 

This control senuonc.e alters the node of the running 
head to that specified hv the parameter "p". Anv of 
the following parameters are allowed: 

C F mt f n The header will be cenrnred on the pn^e. 

MARGIN The header '-/ill be adjusted against the right 
margin of the page. 
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R/R6 I? 



PAP ! MR 

On even-number eh pages, t^e header 

adjusted against the left margin, 
numbered cages against the right. 

wi 1 i 

on 

h n 

o^d 

OPpngFn 

The header will he adjusted against 
opoosite margin f ro r1 the page number. 

the 

Ip the absence of a .HFAP| M R M OOF 

sequence, t K e default option is OP PH PRO. 

control 


, O rf d na rrp 

This control ,, nr’i r.nusps t^e current pao-o to ho printed 
out, and tbe pn.xt page to he rumhered ..with the n°xt 
higher odd ppo-r number, 

. p a g i r g no He Pi n P ... Pn 

This control sequence alters the mode of page 

numbering to that specified by the parameter PI, P2, 
etc. The Pi's may be in any order, and selected from 
the following list: 

MARGIN Page nunhers will he adjusted against the 
right margin. 

FACING Odd page numbers are adjusted against the 
right margin, even page numbers are adjusted 
against the left margin. 


rFNTFP 

Page 
and 1 

numhers are centered between 
eft margin. 

the 

right 

T"P 

Page 

from 

numhers are placed or. 
th« ton of the page. 

the 

fourth 

1 i ne 

RDTTOu 

Page 

fro m 

numbers are placed on 
the bottom o-F the page 

the 

• 

fourth 

1 i ne 

OPP 

Op\ rrn 

numbers are dis r ont'nu 

ed. 




prppiy "string" The string of characters between 
quotation marks is prefixed to the page 
number. The quotation marks may he next to 
each other, in which case no prefix is used. 


ROMANI' 

Page numhers will he 
Roman numera 1 s . 

printed in 

uoper 

case 

ROM A ML 

Page numbers wi 1 1 he 
Roman numerals. 

pr i r ted in 

1 owe r 

case 

ARAB I 0 

Page numhers wi 1 1 
(This is the normal i 

be printed 
mode . ) 

in Arabic. 



* ' 
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Sect 


ion AM 


)/ on 


15 


4 

f 


CC 7 


• SPl t-hp next pa«te number to he u m 

SKIP n Skin "n" pap® nunbprs , 


PARI ^ MOPF severa 1 pi ' 


P 1 s s p^c i f y 


If in a single ijsp of 

competing functions, the last one specific «. , 
precedence. When the .PARINC MOOF ,„ 0 J r ' a ' 1 tak ?s 
text at noint A, all t»'t „o to a ""P ars in 

text after A) will appear on a pare eontroHed L *rT 

ef r fer?"o ^' in ' ^ ' Th « ""'In* node ,.*£« 

effect on the next pare. Then there is no dancer of 

s ™r“ nlmb,,rS hotb « thp ‘"P -’"d hotton of the 


llso of thp TOP parameter may conflict with the 
node. If a heading and a nan? number should he 
in the same column, the oarre number 
pr ecedencn . 


heading 
pr i nted 
will take 


I n the absence of a 
default ontions are: 


PAR I MR MOOF 
TOP MAROIM 


control sequence, 
PPFHX "PAOF " 


the 


append A 


Take as the next innut line the first 1 ? of 

an*:„d?r " h ?'* I* appended "and 

nnCorr ' S ' rr ^-rs ihl e process - that 
xllNOFF encounters the .APPFMn control woM i f 

sv/'tch to file A (MFMO) and continue from its fJr _, 
the control "word) wi 1 Pno^he' proceed ' by ' PUHO^^he 

:f , stt,{ M ::^h™ y f,r:/and s - ----- 


A (memo). 
that the 

i s , once 

wi 1 1 


^ase^M ? 1 W ? rdS may , bo in either unper C a S e nr lower 

case. Illegal control words are i,nomd hy he R ,Sff 

word, as lonrrit ?s y on°th: r ^ ^ ^ ™ 


command. 


same ] ? ne . 


Ahbrevi a t i ons 


All control words may be abbreviated if desired 

■PWI Of I nor r • . > ' • J ' 


abbreviations is civan in tha' sumarv! ' 'Tn'^t \lill °! 

single word is abbreviated by <-ivinr its first 'two 
word'.' 0 ''- ar * '"'hmvtofd ** Uvioc tho first latter of each 


Manuscr i nt Convention.; 

The RUNOFF program assumes a pa-^e leneth of n inches with 

?n£ IT i- rh ; T - *"• -rl"; 

narco. If a header is ft will V [% h 
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f rn ~ t n P of p n pp. The firs 1 : pnpp is not numbered, 

nor is it cr i v e n t'"° bonder Tine, unless t b e control words 
".bonder" end ".pt'V’-e 1" app»ir before the first line of 

text. 

Customer" margins are 1-1/2 inches on the left and 1 inch on 
the ri.cht, implying a 60-character line. This is the 
standard line length in the absence of margin control words. 

(ini ess restrained from doino- so by NOWA I T, the program stops * 
hefore the first name for loading of naner. The STOP 

pa fpmpfer W* 1 1 cense a Ston between all pae-ns. The pa per ★ 

should be 1 ea ded s^ that after the first earriao-p return 
tyninm won 1 d take olare on 1 i pe 1 of the naner. The left 

narmin stop of the tyoe»»riter should be placed at the point 
tvnin^ will betrfn, and the right margin moved ns far 
ns possible. Mow, when you type the first carriage return, 
the procram wi 1 1 start typin" and cant i nne to the end of the 
f i Ip. 


Tabs 

When performing ri "'ht-adjustment, the RUmoff command does 
not take special account of the tabulate characters. 
Therefore, tabs should not he used unless "fill" mode is 
off. If tabs on a 1060 are not set at the CTSS standard 
snhtincs of 16, 30, 46, etc., the supervisor may mistime 
characters or insert extra carriage returns. For this 
reason, use of tab characters is not recommended. 

If a memo does use tabs in a section 'where "fill" is off, 
the mechanical tab stops on the typewriter must be set 
properly. The following conventions should be use' 1 in any 
memo which uses tabs: The first two lines of the memo 
should contain two comments, beginning with the words ".SFT 
TABS AT", followed by a string of blanks and x's, wi th the 
x's positioned at the desired tab stop positions. The 
second comment should be ".TAPS SFT AT" followed hv a strinc 
Of tabs and x's. If the tye«writer is correctly set tin, the 
typset request " D RINT 3" wi 1 1 cause the two lines to bn 
printed out with the x's lined up. Since the supervisor 
assumes that tab stops are at 1.6, 30, 46, etc., a line wi th 
too many tab characters may appear to overflow the carriage 
size, and the supervi sor may insert extra returns. 


Backs nac i nc 

Underlining or overtyping may he accomplished with the aid 
of the backspace key, even in a line that. is subject to 
ri ght adjustment. 
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o u.mma s’ y <)r «■ 1 1 i'|i ' t- i.opr rn I Wn f rt < 


abbrev. 

control word 

automatic break 

. a p 

.apnend A 

no 

. 1 1 

•line length n 

no 

• pl 

.paper leneth n 

no 

. i n 

.indent n 

no 

. un 

.undent n 

ves 

. ss 

.single space 

yes 

. ds 

.double space 

yes 

. bp 

. bep i n pare 

yes 

.ad 

.adjust 

yes 

.f i 

.fill 

yes 

. nf 

. nof ? 1 1 

yes 

. pa 

.pafre (n) 

yes, if n 

. sp 

.space (n) 

yes 

.he 

.header xxxx 

no 

.br 

.break 

yes 

. ce 

.center 

ye s 

. 1 i 

. 1 i tera 1 

no 

. hm 

. bead i np - mode P 

no 

.op 

.odd nape 

yes 

. pm 

. n a <r i p jr no d e P 

no 


If "automatic break" is. yes, the lines before and after tbe 
control word will never be run together, and tbe previous 
line will be printed out in its entirety before the control 
word takes effect. 


(FNH) 
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-Hentif lraff» p 

Interface between user and PTSS 
. SAVED • 

N. I. Morris, X 6010, T.s. 504 
Purpose 


Revised: 9/30/66 


. SAVED (read "dot" - or "point" r ,, 
interface between the user and CTSS serves as an 

decrease his typing load bv ?!v!n S ' a]1 ? W|n £ the user to 
abbreviation of commandand oaramf/'" 1 Wlde latitude in the 

the chaining o^ola^s ? 3 ' Tn ^f 7 ™' ' th " * 

communicate between consoles ntu ers the ability to 
available through "." ar -e th2 » i f? n . Ven 1 ent f aatures 



Usage 

ailo^ny^sar^Smed lia *° P f" C fi '*: , SI "« 

containing these option settings^n the USt ™ lntain a file 
This file is named "USER PROF??" h , S ° Wn tracks - 
The first time | s " 1 , * 4 . ,s ° na record long, 

will he copied from publlc'fHe Copy ° f USFR PR0F "-" 


1* Initiation: 


RESUME . 


ca rr?age ret^ns? haraCt " r ” R " f °" owed by two 

a. A normal command line may be typed with 
spaces delimiting the parameters as 'usuaf 
owever, additional commands may be typed on 
a given line separated by coirmas with " 

chair " 1 ° f Th f,Ve COmmandS uprising', sfngle 

se^entianj e :uh~?tend!n] to" “ EC “ t ' < ' 

linkages an ri rer, •* f “ending to necessary 
nnKages and resuming itself at the end of 
the chain. For example: 


TAP ALPHA (LIST) , LOAD ALPHA GAMMA , SAVE DELTA , START 

and 


Note that the commas are parameters 
therefore miui be set off by blanks? 


b. There i 


chararter? 0 „=If t -' CU ° n 0n ‘he number of 
characters used m a given command line. 
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More than one console line may be employed by 
making the last parameter on a line be 
'(ETC ) 8 followed by the continuation on the 
next console line. The only restriction on 
command line length (not to be confused with 
command chain length as measured in links) is 
that the total number of parameters 
(including commas/ parentheses, and slashes) 
must be less than 50. 

c. To prevent the resuming of at the end of 
a command chain, terminate the line with the 
parameter ''slash" ("/"). Note that this 
tactic will allow the chaining of six 
commands. Commands which leave a desired 
core-image (e.g. RESTOR, LOAD, etc.) and are 
the last link of a command chain should be 
followed by the slash to prevent destruction 
of the core-image by the "RESUME 

d. Commands and parameters may be concatenated 
by the use of parentheses. For example, the 
command line 

( BEFAP NCLOAD SAVE ) PROG 

wi 1 1 generate 

BEFAP PROG 
NCLOAD PROG 
SAVE PROG 

and the command line 

FAP ( ALPHA BETA GAMMA ) (LIST) 

will generate 

FAP ALPHA (LIST) 

FAP BETA (LIST) 

FAP GAMMA (LIST) 

Abbrev i at i ons : 

a. Often-used commands and parameters may be 
abbreviated in". SAVED". The abbreviation 
definitions are stored in the user's "USER 
PROFIL". They may be determined through the 
use of the internal commands 

ABBREV COM 
ABBREV PAR 

Note that "USER PROFIL" cannot be PRINTed 
successfully. The "ABBREV" command must be 




used to examine its contents. 

To define abbreviations, the internal 
commands are "DC" (for commands) and "DP" 
(for parameters). General form is 

DC abl coml ab2 com2 ... abn comn 
DP abl pari ab2 par2 ... abn parn 

For example: DC LO LOGOUT 

To remove abbreviations, the internal 
commands are "RC" and "RP". General form is 
as foil ows : 

RC abl ab2 ... abn 
RP abl ab2 . . . abn 

Example: RC LO 


The abb rev i a t i on tables can each contain a * 
maximum, of 75 definitions. A parameter 
definition will take precedence over a 
command abbreviation, where "command" is 
understood to be the first item in a "command 
1 i ne" . 


Two types of parameter abbreviations are 
permanently defined; they are automatically 
provided for and do not appear in the 
parameter abbreviation table: 

"Ox" is the abbreviation for "CMFLOx". 
".x" is the abbreviation for "(CFLx)". 


Private commands: 

"SAVED" files may be resumed without explicit 
use of the "RESUME" command. maintains a 

list of the primary names of "SAVED" files in 
"USER PROFIL". This list is consulted 
whenever a command is issued to determine if 
a "SAVED" version exists and a "RESUME" 
command should be generated. For example. If 
the user issues the command "ZILCH" and 
ZILCH SAVED'.' exists in his files, then 
will automatically generate a "RESUME ZILCH" 
command. This private command list may be 
updated through the use of the internal 
command "UPDPRI" which searches the user's 
file directory for "SAVED" files. Note that 
if ZILCH SAVED" is created and "UPDPRI" not 
issued, "." will not "know" that "ZILCH" 
refers to a private "SAVED" file. 



I »ff 
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N.B. 


The private command list check 
be turned off by issuing the i 
"SVLiST OFF" . ! n this mode, " 

an FSTATE for each command it 
order to check for a private " 
This mode is cons i derab i v si 
SVLIST ON" mode. When "." is 
first time, it will be in the 
mode. Issuing the "UPDPRI" 
update the user's "SAVED" f i 1 
PROFIL" and turn "SVLIST ON" a 


ing feature may 
command 
per form 


nternal 
." wi 1 I 

<rpn p r 

SAVED" 

ower t 


a foe 


? n 


used 
"SVLI 
comma 
es i nt 
utomat i 


vers I on . 

han the 
for the 
ST OFF" 
nd will 
o "USER 
cal 1 y. 


Beware of the presence of "LOGOUT SAVED" when 
issuing the "UPDPRI" command! 


File sys tern calls: 

ircfLr- Si ?7, la r manner to the treatment of 
RFSUMEs (private commands"), "." will also 

^o^tlceiny furnish the "CALL" command (see 
AH. 6. 07) for file system subroutine calls. 
The following subroutines can be CALLed by 
typing the name of the entry followed by the 
necessary arguments: 


ALLOT 
ATTACH 
ATTNAM 
CHF I LE 


DELFIL 
FSTATE 
I0DIAG 
MOVFI L 


OPEN 

SETPRI 

TRFILE 


For example, "STORGE 2" 
command "CALL STORGE 2". 


will generate the 


Interconsole communications: 

When a user is in ". SAVED" either in waiting 
input or sleeping status, an interconsole 
message may be received. (Whenever the user 
enters a command line and "." is left, all 
communication is forbidden). This will 
prevent the user from receiving Interconsole 
messages in his input buffer while editing, 
typsetting, etc.) 

To use the interconsole communications 
feature of ". SAVED", the user must have a 
link to "WRITE SAVED" In public file. 
Interconsole messages are sent using the 
revised ASCII character set. This permits 
the user to communicate using upper and lower 
case and all special characters. As In 
’ TY PSET is the erase character, and "@" 
is the kill character. 


a. To send an Interconsole message, use the 
internal command "WRITE" followed by the 
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• on AJ.2, 


b. 


c. 


d. 


problem ann ^ 

whom Che mess"a~ of - e U3 _ _ 

ssw.d£r * to ~. s u«£ 

3187 could reply by typing ^TTn's^trV 


communications* r<? uJe * ' the.° ^ | 3 1 ’ lnterc onsol e 
"FORBID". USe the Internal comnand 


To pe f mi t a particular user t-o 

??%£"? ! nt8r ^ al command "allow P C RSR Un L Cate ' 

lLZ™ G „l s ^™'t ted, all users PRnR " 


number "PROB" wf 1 1 'bS Ml i use ^ s w ' th problem 
If 'PROB" is "*» a lowed to communicate 
number "PROG" win" b “ Se :?, w, ‘ h Programm^ 
PROS" and "PRnfi" ..... ° wed * IF both 


6 - Sleeping: 


7. 


. , aiiu rKUU" are nmTt«-«rj 11 noth 

be allowed. ted / everybody win 

left'bTgfw'g'l stng!r% r f eak-' S sr D ", may be 

routines^o t 'ST'??”” 

SAVED". Co a fresh version 0 f " 


The internal command "rs" . . 

sleeping program which wfli wake fnftfate a 

Ti n y?es and print a comment L n P 6 ^ ry ten 
of lines to the computer In \u , Monopo 11 za t i on 
rather anti-social^ l ? hls fashion is 
unless absolutely # necessary d T be done 
messages may be recelvln 'nterconsole 

sleeping. A^ter r ? P,ied to whfle 

completed, a single "break^wm 3t ' °" S are 
user to sleep. ( n order to retUrn the 
command/ it is necessarv to ? USe the " R S" 

"WRITE SAVED" m pubUc fHe a llnk 


to 


Response supression: 

Successive usages 
v * . (ver i fy) wi 1 l 
permit printing 
characters "R" and 
comment. 


of the internal corner) 
a of 6rn the ly J Upp " eSs and 

- acknowledgement 

thp sleeping 


ii V IR acknov 
W and of the 


8. 


Termination: 

to^ea^^JaJus^CLo' ' WM 1 the user 

be accomplished while in °" t ..? ay ' °L, < r 0Urs ^ 
Prohibit further interconsoi* * Q "Ml 
before going DEAD. uH 2?if common 1 ca t ion 

IS Wise never to quit 
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out of but to always use "0". 
Otherwise, the user may receive interconsole 
messages unexpectedly. 
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I Henti fi cation 

Interface between user and CTSS. 
. SAVED 

N. I. Morris, X 6010, T.S. 504 


Revised: 9/30/66 


Purpose 

. SAVED (read "dot" - or "point" - saved) serves as an 
interface between the user and CTSS, allowing: the user to 
decrease his typing load by giving him wide latitude in the 
abbreviation of command and parameter names. It also allows 
the chaining of commands, and offers the ability to 
communicate between consoles. Other convenient features 
available through "." are the ability to concatenate 
commands with the same arguments, automatic resumption of 
SAVED files (the R command need not be given), automatic 
file system CALLS, optional suppression of printing of 
W(ait) and R(eady) lines, and the ability to initiate 
execution of a SLEEPING program. 


Usage 

"." may be used through a link to public file. Since "." 
allows many user modified options, it must maintain a file * 
containing these option settings in the user's own tracks. 
This file is named "USER PROFIL" and is one record long. 

The first time is used, a standard copy of "US^R PROFIL" 

will be copied from public file. 


1 . Initiation: 


RESUME . 


Response is the character "R" followed by two 
carriage returns. 

a. A normal command line may be typed, with 
spaces delimiting the parameters as usual. 
However, additional commands may be typed on 
a given line separated by commas, with a 
maximum of five commands comprising a single 
chain. These commands will be executed 
sequentially with "."attending to necessary 
linkages and resuming itself at the end of 
the chain. For example: 

FAP ALPHA (LIST) , LOAD ALPHA GAMMA , SAVE DELTA , START 

Note that the commas are parameters and 
therefore must be set off by blanks. 

b. There is no restriction on the number of 
characters used in a given command line. 



C&l 41 


*A/\ \ 
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Mors than ons console line may be employed by 

5 h< ?, last P aram eter on a line be 
(ETC) followed by the continuation on the 
next console line. The only restriction on 
command line length (not to be confused with 
command chain length as measured in links) is 
that the total number of parameters 

( including commas, parentheses, and slashes) 
must be less than 50. 

c . 


d. 


( BEFAP NC LOAD SAVE ) PROG 
wi 1 1 generate 


To prevent the resuming of 
a command chain, terminate 
parameter "slash" ("/"), 
tactic will allow the 
commands. Commands which 

RRST0R ' LOAD, etc.) and are 
the last link of a command chain should be 
followed by the slash to prevent destruction 
or the core-image by the "RFSUME " 


. at the end of 
the 1 i ne wi th the 
Note that this 
chaining of six 
leave a desired 


Commands and parameters may be concatenated 
by the use of parentheses. For example, the 
command line 


BEFAP PROG 
NCLOAD PROG 
SAVE PROG 


and the command line 


FAP ( ALPHA BETA GAMMA ) (LIST) 
will generate 


FAP ALPHA (LIST) 
FAP BETA (LIST) 
FAP GAMMA (LIST) 


Abbreviations : 


Oft en -use d commands and parameters may be 
abbreviated In SAVED". The abbreviation 

st ° re <i in the user's "USER 

use of T t' e i may , be determined through the 
use of the internal commands 


ABBREV COM 
ABBREV PAR 


Note that " 
successfu 1 1 


USER PROFIL" cannot be 
y. The "ABBREV" command 


PR INTed 
must be 


* 


f 2 
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used to examine its contents. 

To define abbreviations, the internal 
commands are "DC" (for commands) and "DP" 
(for parameters). General form Is 

DC abl coml ab2 com2 ... abn comn 
DP abl pari ab2 par2 ... abn parn 

For example: DC LO LOGOUT 

To remove abbreviations, the internal 
commands are "RC" and "RP". General form is 
as foil ows : 

RC ab 1 ab2 . . . abn 
RP abl ab2 . . . abn 

Example: RC LO 

The abbreviation tables can each contain a 
maximum of 75 definitions. A parameter 
definition will take precedence over a 
command abbreviation, where "command" is 
understood to be the first item in a "command 
1 i ne" . 

Two types of parameter abbreviations are 
permanently defined; they are automatically 
provided for and do not appear in the 
parameter abbreviation table: 

"Ox" is the abbreviation for "CMFLOx". 
".x" is the abbreviation for "(CFLx)". 

commands : 

"SAVED" files may be resumed without explicit 
use of the "RESUME" command. "." maintains a 
list of the primary names of "SAVED" files in 
"USER PROFIL". This list is consulted 
whenever a command is issued to determine if 
a "SAVED" version exists and a "RESUME" 
command should be generated. For example, if 
the user issues the command "ZILCH" and 
"ZILCH SAVED" exists in his files, then 
will automatically generate a "RESUME ZILCH" 
command. This private command list may be 
updated through the use of the internal 
command "UPDPRI" which searches the user's 
file directory for "SAVED" files. Note that 
if "ZILCH SAVED" is created and "UPDPRI" not 
issued, will not "know" that "ZILCH" 

refers to a private "SAVED" file. 


★ 
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The private command list checking feature may 
be turned off by issuing the internal command 
"SV LIST OFF". In this mode, will perform 
an FSTATE for each command it generates in 
order to check for a private "SAVED" version. 
This mode is cons i derabl y s 1 ower than the 
"SVLIST ON" mode. When "." is used for the 
first time, it will be in the "SVLIST OFF" 
mode. Issuing the "UPDPRI" command will 
update the user's "SAVED" files into "USER 
PROFIL" and turn "SVLIST ON" automatically. 

N.B. Beware of the presence of "LOGOUT SAVED" when 
issuing the "UPDPRI" command! 


File system calls: 

In a similar manner to the treatment of 
RESUMES ("private commands"), will also 
automatically furnish the "CALL" command (see 
AH. 6. 07) for file system subroutine calls. 
The following subroutines can be CALLed by 
typing the name of the entry followed by the 
necessary arguments: 


ALLOT 
ATTACH 
ATTNAM 
CHF I LE 


DELFI L 
FSTATE 
I0DIAG 
MOV FI L 


OPEN 

SETPRI 

TRFILE 


For example, "STORGE 2" will generate the 
command "CALL STORGE 2". 

Interconsole communications: 

When a user is in ". SAVED" either in waiting 
input or sleeping status, an interconsole 
message may be received. (Whenever the user 
enters a command line and "." is left, all 
communication is forbidden). This will 
prevent the user from receiving interconsole 
messages in his input buffer while editing, 
typsetting, etc.) 


To use the interconsole communications 
feature of ". SAVED", the user must have a 
link to "WRITE SAVED" in public file. 
Interconsole messages are sent using the 
revised ASCII character set. This permits 
the user to communicate using upper and lower 
case and all special characters. As in 
"TYPSET", is the erase character, and 

is the kill character. 

a. To send an interconsole message, use the 
internal command "WRITE" followed by the 
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problem and programmer number of the user to 
whom the message is being sent. . . t u' 

"WRITE T234 3187" would 1 "iSlf %187 

transmission of a message to T234 
Subsequent input lines would be received by 
T234 3187 if he desired to communicate. TZ3 
3187 could reply by typing his answer. 

To prohibit the reception o* all 1 n J erco "i°^ 
communications, use the internal command 

"FORBID". 

_ « l ! riii si* iic or to corn mu n i c 3 1 0 / 

To permit a particular user lu £ prqg m 

use the internal command ALLOW PROR PROG . 

If PROG is omitted, all users with pr . 

number "PROB" will be allowed to communicate. 

™ "PROB" is all users with Programmer 

number "PROG" will be allowed. If both 

"PROB" and "PROG" are omitted, everybody will 

be al lowed. 

The interconsole section of ".SAVED may be 
left by giving a single "break signal. JJj'* 
will cause the interconsole communications 
routines to exit to a fresh version of 
S£VED". 


Sleeping*. ^ . nternal command "R S " will initiate a 
sleeping program which will wake up every ten 
minutes and print a comment. Monopol.za . 
of lines to the computer In this fashion 
rather anti-social, and should not ^ done 
unless absolutely necessary. nterconso e 

messages may be deceived and replied to while 
s -j eepi ng . After communications are 

completed, a single "break" will return the 
user to sleep. In order to use the RS 
command. It is necessary to have a link 
"WRITE SAVED" in public file. 


Response ^ession of the internal command 

"V " (verify) will alternately suppress and 
permit printing of the acknowledgement 
characters "R" and "W" and of the sleeping 
comment . 

Termination:^ command , Q . w m return the user 

to dead status. (Longing out may, of cour e, 

be accomplished while in 

prohibit further interconsole communication 
before going DEAD. It is wise never to quit 
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out of but to always use "0". 
Otherwise, the user may receive interconsole 
messages unexpectedly. 
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I dent If 1 cati on 

Copy a file; Append one file to another. 

MOVE SAVED; A PND SAVED 

N. I . Morris, X6010, 8/15/66 

Purpose 

MOVE may be used to copy a file from disk onto file, system 
tape or to read a file from file system tape onto the disk. 
In addition, MOVE can be used In the same manner as TRNSMT 
SAVED to move a file through a link. APND Is used to append 
one file to another. 

Usage 


R MOVE NAME1 NAME2 NAME3 -NAME4- 

R APND NAME1 NAME2 NAME3 -NAME4- 

NAME1 NAME2 is the name of the file to be MOVEd or 

APpeNDed . 

NAME3 NAME4 is the name of the file to be written. If 

NAME4 is omitted, NAME2 is assumed. If NAME3 

is NAME1 is assumed. 

Execution 

NAME1 NAME2 is opened for reading and NAME3 
NAME4 is opened for writing. (If MOVE is 

being used, MAME3 NAME4 is truncated to 
zero-length.) Then, the contents of NAME1 

NAME2 are copied into (or appended to) NAME3 
NAME4 by a high-speed file copying routine. 
This copying routine is triple-buffered so 
that tape to disk and disk to tape copying 
can actually run two data channels 
simultaneously. Note that the file NAME1 
NAME2 is unaffected by MOVEing or APNDing. 

Wr i ting tape f 1 les 

A file may be MOVEd from disk to tape by the 
following sequence of commands. (Assume that 
the tape has already been MOUNTed and 
LABELled.) : 


TAPF1L NAME 3 NAME4 UNIT 0 
R MOVE NAME1 NAME2 NAME 3 NAME4 
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Read I ng tape f i > d.~. 


*** ^ rs r } i 


is ready several words of garbage may. be 
appended to the last record of the file. 
This is caused by a paradox in the file 
system. (The first time a tape file is ready 
the file system doesn't know the correct 
length of the file. After the gpt j.r.£ file is 
read oncey the correct length will be updated 
into the file system. Contact the author if 
you re a 1 1 v want a technical explanation of 
this problem. The reason is quite 

complicated.) MOVE will compensate. for this 
f i 1 e-system problem by determining the 
correct length of the file and ignoring the 
garbage words. ThuSy MOVE should always, be 
used to read a tape file for the first time. 
To MOVE a file from tape to disky use the 
following sequence: 


TAPFIL NAME1 NAME2 UNIT FILE 
R MOVE NAMEl NAME2 NAME 3 NAME4 
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